home *** CD-ROM | disk | FTP | other *** search
/ Carousel Volume 2 #1 / carousel.iso / mactosh / util / bbin051.sit / Batch Binary Docs next >
Text File  |  1989-06-05  |  5KB  |  97 lines
  1. Batch MacBinary Version 0.51 Documentation June 5 1989
  2.  
  3. What is MacBinary?
  4.  
  5. MacBinary is a file format that is used in cases where it is necessary to store Macintosh files on
  6. other computing systems, such as MS-DOS machines. The need for this file format arises from the fact
  7. that many Macintosh files consist of two extents, the resource and data forks, and contain information
  8. such as the creator and type. This type of file structure is unique to the Macintosh environment, and
  9. is not supported by other file systems. To prevent loss of information when transferring files to
  10. other operating environments, the MacBinary format was devised. Simply, it packages the type and
  11. creator information into a header, and the resource and data forks into a single extent. The resulting
  12. file can be stored on many hardware platforms, and easily converted back into a Macintosh format file.
  13.  
  14. MacBinary was developed primarily for use with telecommunications programs; currently all popular
  15. Macintosh terminal programs incorporate MacBinary processing as a more-or-less transparent part of
  16. their file transfer operations.
  17.  
  18. But there is a "gotcha". Files existing in MacBinary format, when transferred to a Macintosh platform
  19. by means such as a TOPS network, or use of the Apple File Exchange software in conjunction with an
  20. Apple SuperDrive, or any other file transfer protocol that does not incorporate MacBinary translation
  21. remain in MacBinary format, which is essentially unusable by the Macintosh. Currently there exists
  22. one, and only one method to perform this translation ad hoc, that being the BinHex 5 utility written
  23. several years ago by Yves Lempereur. This utility works well, and should be part of everyone's
  24. software library.
  25.  
  26. However, in these days of interoperability, the common use of Macintosh computers in formerly
  27. true-blue shops, and common operation of Mac oriented BBS's on MS-DOS and other computer platforms,
  28. and the advances made in Macintosh performance over the past couple of years, there is obviously a
  29. severe limitation to a tool like BinHex 5. It performs one, and only one file translation at a time.
  30. For a BBS operator trying to maintain a virus-free library of thousands of files on a non-Macintosh
  31. platform, this is intolerable. LÄo Laporte found this out during the operation of his late, lamented
  32. MacQ BBS (one of the finest BBS's, and sysops ever to grace Fidonet) and started construction of a
  33. batch MacBinary utility. Unfortunately he never finished the project. 
  34.  
  35. This program is what LÄo envisioned.
  36.  
  37. What does Batch MacBinary do?
  38.  
  39. Simply, Batch MacBinary takes a folder containing several files in MacBinary format, and converts them
  40. all to native Macintosh format in one quick step. Operation of the program is simple in the extreme.
  41. Just pull down the appropriate selection from the Conversion menu, and select any file from the folder
  42. that you wish converted. All the MacBinary files in the folder will be converted to native Mac format.
  43. This includes text files, which will have linefeeds and other gremlins zapped. Be careful not to
  44. convert PC based Arc, Zip etc. files. This process will corrupt them.
  45.  
  46. Caveats:
  47.  
  48. This program is in it's early stages, and has not been tested in great depth. If you have problems with it,
  49. please let me know. As far as I know it should run on all Macs, but there is a possibility that it
  50. might not run under MFS.
  51.  
  52. Two types of errors are most likely; skipping a file that was intended to be converted, and attempting
  53. to convert a file that is not MacBinary. The former is most likely to occur if you have more than 1024
  54. files in your conversion folder. I you notice either type of problem, let me know. If it is a case of
  55. non-Macbinary files being converted, please inform me so I can beef up the MacBinary detection
  56. routine.
  57.  
  58. License:
  59.  
  60. This program is free to individuals operating in a non-commercial environment, or in association with
  61. a BBS that does not charge any access fees. If you generate income in any fashion associated with the use
  62. of this program, you are expected to pay a registration fee.
  63.  
  64. This program may be freely distibuted by any manner, so long as this documentation and the program are
  65. distributed together, unaltered. Fees above normal connect time, disk and mailing costs may not be
  66. charged.
  67.  
  68. Organizations making a profit from the distribution of shareware and public domain software must write
  69. to the address below to obtain a license to distribute this software.
  70.  
  71. A $25 per copy in use registration fee is required from those using this program in any way associated with a
  72. commercial, profit or non-profit, or governmental operations, or a BBS or other information 
  73. provider that charges membership or access fees of any sort.
  74.  
  75. This program, with the exception of the source code provided by Leo Laporte, is Copyright 1989 by Eric
  76. Larson. All rights except those expressly provided for above are reserved.
  77.  
  78. Registration fees and bug reports should be sent to:
  79.  
  80. Eric Larson 
  81. 2902 Falls Road 
  82. Marcellus, NY 13108 USA 
  83. Fidonet 1:260/330.0
  84.  
  85. Future planned enhancements:
  86.  
  87. Version 1.0 will contain a MacBinary encoding routine.
  88.  
  89. Enhanced Multifinder friendliness and MacBinary II may be added in the future.
  90.  
  91. Warranty:
  92.  
  93. There is no warranty of merchantability or fitness for any use. No liability for direct, indirect,
  94. special or consequential damages, or loss of data, revenue or use is assumed. Determination for
  95. fitness in a given application lies solely with the user.
  96.  
  97.